Plua Compiler, or pluac, is a desktop application that compiles Plua source
code into a PRC executable. Currently there are versions for Windows and Linux,
both for the x86 architecture.

Plua is a port of Lua 4.0 (plus a small IDE) for the Palm Computing platform.
Lua is a programming language designed at TeCGraf, the Computer Graphics
Technology Group of PUC-Rio, Brazil.

More information on Lua can be found at http://www.lua.org.
(NOTE: I have no affiliation with TeCGraf or PUC-Rio)

THIS SOFTWARE COMES WITH ABSOLUTELY NO WARRANTY, SO USE IT AT YOUR OWN RISK.

Plua is Copyright (c) 2001 Marcio M. Andrade.

-----------

pluac is a command line application, which means it has no GUI and runs on a
console window. For a description of the available options, run pluac with no
arguments:

Usage: pluac [-l] <name> <cid> <ver> <file.prc> <file.lua> [<res.bin> ...]
Options:
      -l: compiles a library instead of a full application
Arguments:
    name: application name
     cid: application creator ID as a four letter string
     ver: application version string (ex.: 1.0)
file.prc: PRC output file
file.lua: Lua source code file
 res.bin: optional PilRC-compatible binary resource file (ex.: tAIB03e8.bin)

Suppose your Plua application is named "My Test Application", the source code
is stored in the file test.lua, and you have registered the creator ID "Test".
The command line to build test.prc is:

pluac "My Test Application" Test 1.0 test.prc test.lua

The generated test.prc may now be installed on your Palm device and run as any
other application (provided you have either Plua or Plua runtime installed).

pluac also supports embebdding of resource files, a feature not available on the
onboard Plua application. You may create, for example, an icon bitmap for your
application. All arguments after the Lua source file are expected to be binary
resource files, and are compiled into the PRC.

pluac is not a resource compiler, so you will need a third party application
to create the binary resource files expected by pluac. A common choice is PilRC,
and in fact pluac expects resource file names like the ones produced by PilRC.

All resource file names must adhere to the form: ttttnnnn.bin, where tttt is
the four letter resource type and nnnn is the four digit reource ID in 
hexadecimal. A icon resource has type tAIB and ID 1000 (decimal). PilRC will
create a file named tAIB03e8.bin for an icon resource, since is uses hexadecimal
for IDs.

The modified command line to build test.prc with an icon resource would be:

pluac "My Test Application" Test 1.0 test.prc test.lua tAIB03e8.bin
